Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Transforming Points and Vectors

Q3Point3D_To3DTransformArray

You can use the Q3Point3D_To3DTransformArray function to apply a transform to each point in an array of three-dimensional points.

TQ3Status Q3Point3D_To3DTransformArray (
const TQ3Point3D *inVertex, 
const TQ3Matrix4x4 *matrix, 
TQ3Point3D *outVertex, 
long numVertices, 
unsigned long inStructSize, 
unsigned long outStructSize);

inVertex

A pointer to an array of three-dimensional points. This is the source array.

matrix

A 4-by-4 matrix.

outVertex

A pointer to an array of three-dimensional points. This is the destination array.

numVertices

The number of vertices.

inStructSize

The size of an element in the source array. Effectively, this is the distance, in bytes, between successive points in the source array.

outStructSize

The size of an element in the destination array. Effectively, this is the distance, in bytes, between successive points in the destination array.

DESCRIPTION

The Q3Point3D_To3DTransformArray function returns, in the outVertex parameter, an array of three-dimensional points, each of which is the result of multiplying a point in the inVertex array by the matrix transform matrix. The outVertex array contains the same number of points (that is, vertices) as the inVertex array, as specified by the numVertices parameter. The inStructSize and outStructSize parameters specify the sizes of an element in the inVertex and outVertex arrays, respectively.